My97 WdatePicker：跨框架民国年日历控件详解

"这篇文档详细介绍了WdatePicker日历控件的使用方法，包括其跨框架显示、特殊日历设置、编程便利性以及其他属性，同时提到了多语言支持和自定义皮肤的功能。" WdatePicker是一款强大的JavaScript日历控件，主要针对网页中的日期输入进行增强，提供丰富的功能和自定义选项。以下是对该控件各方面的详细说明： 1. **跨无限级框架显示**：WdatePicker能够穿透任意层级的iframe框架，确保控件始终可见，不会被框架遮挡，即便页面存在滚动条也能正常工作。这对于复杂的网页结构特别有用，能保证用户体验。 2. **特殊日历格式**：通过设置`yearOffset`属性，用户可以创建民国年或其他特殊年份的日历。默认值为1911，对应民国元年。例如，当设置年份格式为`yyy`时，实际日期会减去`yearOffset`值，实现民国年显示。 3. **编程友好**： - 如果`el`参数设置为`this`，可以省略，意味着所有`el: this`都可以不写。 - 当日期框设为`disabled`，则禁止用户更改日期，不会弹出选择框。 - 若未定义`onpicked`事件，控件会选择自动触发文本框的`onchange`事件。 - 若未定义`oncleared`事件，清空日期时，控件同样会触发`onchange`事件。 4. **其他属性**： - `readOnly`属性可设置日期框为只读，防止用户手动修改。 - `highLineWeekDay`若设为`true`，将高亮显示周末日期。 - `isShowOthers`属性控制是否显示其他月份的日期，便于用户选择跨越月份的日期范围。 - 添加`class="Wdate"`到输入框，会在右侧显示日期图标，提供直观的交互提示。 5. **多语言支持**：WdatePicker支持多种语言，如繁体中文、英文和简体中文。通过`lang`属性可以为每个日期控件单独设置语言，或者全局配置。例如： - 繁体中文：`<input id="d311" class="Wdate" type="text" onFocus="WdatePicker({lang: 'zh-tw'})"/>` - 英文：`<input id="d312" class="Wdate" type="text" onFocus="WdatePicker({lang: 'en'})"/>` - 简体中文：`<input id="d313" class="Wdate" type="text" onFocus="WdatePicker({lang: 'zh-cn'})"/>` 6. **自定义皮肤**：WdatePicker允许用户自定义皮肤，以适应不同的网页设计风格，提供了丰富的个性化设置选项，使日期控件更好地融入网站整体视觉效果。 WdatePicker是一个强大且灵活的日期选择工具，它提供的特性使得在网页开发中处理日期输入变得简单而高效。无论是语言切换、框架兼容还是样式定制，都能满足开发者和用户的多样化需求。