支付寶小程序其他手勢(shì) 日歷·Calendar

2020-09-18 11:25 更新

單日歷組件。不支持跨頁選擇日期范圍。

掃碼體驗(yàn)

image

示例代碼

{
  "defaultTitle": "Calendar",
  "usingComponents":{
    "calendar": "mini-ali-ui/es/calendar/index"
  }
}
<view>
  <calendar
    type="range"
    haveYear="{{true}}"
    tagData="{{tagData}}"
    onSelect="handleSelect"
    onMonthChange="onMonthChange"
    onYearChange="onYearChange"
        onChange="onChange"
    onSelectHasDisableDate="onSelectHasDisableDate" />
</view>
Page({
  data: {
    tagData: [
      { date: '2020-02-14', tag: '顏色 1', tagColor: 1 },
      { date: '2020-02-28', tag: '公積金', tagColor: 2 },
      { date: '2020-02-24', tag: '顏色 3', tagColor: 3 },
      { date: '2020-02-18', tag: '顏色 4', tagColor: 4 },
      { date: '2020-02-4', tag: '還房貸', tagColor: 5 },
      { date: '2020-02-10', tag: '公積金', disable: true },
    ],
  },
  handleSelect() {},
  onMonthChange() {},
  onYearChange() {},
  onChange() {},
  onSelectHasDisableDate() {
    my.alert({
      content: 'SelectHasDisableDate',
    });
  },
});

屬性

屬性 類型 默認(rèn)值 描述 最低版本
className String - 自定義 class。 -
type String single 選擇類型??蛇x值:single: 單日 range: 日期區(qū)間。 -
haveYear Boolean false 是否展示年份控制箭頭。 -
prevMonthDisable Boolean false 前一個(gè)月份箭頭禁用。 -
prevYearDisable Boolean false 前一個(gè)年份箭頭禁用。 -
nextvMonthDisable Boolean false 后一個(gè)月份箭頭禁用。 -
nextYearDisable Boolean false 后一個(gè)年份箭頭禁用。 -
tagData Array - [{ date: '日期', tag: '標(biāo)簽', tagColor: 1, disable: true,},],可設(shè)置多個(gè)不同日期的標(biāo)簽內(nèi)容,顏色以及是否禁用。 -
onSelect EventHandle ([startDate, endDate]) => void 選擇區(qū)間時(shí)的回調(diào)。 -
onMonthChange EventHandle (currentMonth, prevMonth) => void 點(diǎn)擊切換月份時(shí)回調(diào),帶兩個(gè)參數(shù)currentMonth切換后月份和prevMonth切換前月份。 -
onChange EventHandle (current, prev) => void 年/月變化時(shí)回調(diào),帶兩個(gè)對(duì)象,每個(gè)均攜帶 year 和 month 信息。 1.1.5
onSelectHasDisableDate EventHandle (currentMonth, prevMonth) => void 選擇區(qū)間包含不可用日期。 -
onYearChange EventHandle (currentYear, prevYear) => void 點(diǎn)擊切換年份時(shí)回調(diào),帶兩個(gè)參數(shù)currentYear切換后年份和prevYear切換前年份。 -

Bug & Tip

  • tagColor 共有 5 種顏色:
    • 1: #ff6010
    • 2: #00b578
    • 3: #ff8f1f
    • 4: #1677ff
    • 5: #999
  • prevMonthDisable、prevYearDisablenextvMonthDisable 以及 nextYearDisable 四個(gè)主要控制日歷上的箭頭是否可點(diǎn)擊使用,可根據(jù)實(shí)際業(yè)務(wù)場(chǎng)景來使用;
  • tagData 中的 disable 是可選項(xiàng),如某日期需要提示禁用不可點(diǎn)時(shí)才需要增加,當(dāng)不可用時(shí),tag 以及 tagColor 將不會(huì)展示;
  • 月份計(jì)數(shù)從 0 開始,即 0 代表 1 月份,以此類推,月份返回值 11 代表 12 月份。
以上內(nèi)容是否對(duì)您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)