[{"data":1,"prerenderedAt":2165},["ShallowReactive",2],{"content-\u002Fcomponents\u002Fcombobox":3,"content-en-fallback-\u002Fcomponents\u002Fcombobox":2164},{"id":4,"title":5,"body":6,"description":2155,"extension":2156,"meta":2157,"nav":2158,"navigation":2159,"path":2160,"seo":2161,"stem":2162,"__hash__":2163},"content\u002Fcomponents\u002Fcombobox.md","Combobox 下拉框",{"type":7,"value":8,"toc":2144},"minimark",[9,13,31,38,41,108,112,128,211,215,247,341,344,382,494,505,550,553,563,734,761,849,860,863,882,948,1040,1043,1058,1150,1153,1168,1263,1266,1288,1349,1353,1765,1891,1952,1999,2140],[10,11,5],"h1",{"id":12},"combobox-下拉框",[14,15,16,17,21,22,26,27,30],"p",{},"下拉框让用户从一组单行文本选项里选一项（颜色、字号、配送方式……）。样式与行为还原 WinUI 3（Windows App SDK 2.0）的 ",[18,19,20],"strong",{},"ComboBox","：几何、状态色、下拉项指示条、面板定位与动画都逐项对照 ",[23,24,25],"code",{},"src\u002Fcontrols\u002Fdev\u002FComboBox\u002FComboBox_themeresources.xaml","；键位、文本搜索、可编辑态对照 ",[23,28,29],{},"src\u002Fdxaml\u002Fxcp\u002Fdxaml\u002Flib\u002FComboBox_Partial.cpp","。",[14,32,33,34,37],{},"交互底座复用 ",[23,35,36],{},"reka-ui"," 的 Combobox 原语（ARIA combobox 语义、roving highlight、弹层定位、外部点击关闭），本组件补齐 WinUI 的键位口径、文本搜索、可编辑态与视觉状态。",[14,39,40],{},"与 WinUI 一致的三条取值口径：",[42,43,44,68,91],"ul",{},[45,46,47,53,54,57,58,61,62,64,65,67],"li",{},[18,48,49,50],{},"无选中就是 ",[23,51,52],{},"null","（对应 WinUI ",[23,55,56],{},"SelectedIndex = -1","）：不传 ",[23,59,60],{},"modelValue"," 时为非受控，",[23,63,52],{}," 表示未选中，清空选中会抛出 ",[23,66,52],{},"；",[45,69,70,53,76,79,80,83,84,87,88,67],{},[18,71,72,73],{},"选项数据走 ",[23,74,75],{},"items",[23,77,78],{},"ItemsSource","），每项 ",[23,81,82],{},"{ value, text?, disabled? }","，",[23,85,86],{},"text"," 缺省取 ",[23,89,90],{},"String(value)",[45,92,93,99,100,103,104,107],{},[18,94,95,98],{},[23,96,97],{},"selectionChangedTrigger"," 决定何时提交","：缺省 ",[23,101,102],{},"committed","——点击 \u002F 回车 \u002F 文本搜索才改选中项；开着面板按方向键只移动高亮（WinUI ",[23,105,106],{},"SelectionChangedTrigger"," 的缺省行为）。",[109,110,111],"h2",{"id":111},"基础用法",[14,113,114,117,118,120,121,124,125,30],{},[23,115,116],{},"v-model"," 绑定选中值，",[23,119,75],{}," 提供选项，",[23,122,123],{},"header"," 是 WinUI 的标题行（同时作为缺省的可访问名），未选中时显示 ",[23,126,127],{},"placeholder",[129,130,131,138],"demo-block",{"title":111},[132,133,135],"template",{"v-slot:preview":134},"",[136,137],"combobox-basic-demo",{},[132,139,140],{"v-slot:code":134},[141,142,146],"pre",{"className":143,"code":144,"language":145,"meta":134,"style":134},"language-vue shiki shiki-themes github-light github-dark","\u003CFluereCombobox v-model=\"picked\" :items=\"COLORS\" header=\"颜色\" placeholder=\"请选择颜色\" \u002F>\n","vue",[23,147,148],{"__ignoreMap":134},[149,150,153,157,161,165,168,172,175,177,180,182,184,186,190,192,195,197,200,203,205,208],"span",{"class":151,"line":152},"line",1,[149,154,156],{"class":155},"sVt8B","\u003C",[149,158,160],{"class":159},"s9eBZ","FluereCombobox",[149,162,164],{"class":163},"sScJk"," v-model",[149,166,167],{"class":155},"=",[149,169,171],{"class":170},"sZZnC","\"",[149,173,174],{"class":155},"picked",[149,176,171],{"class":170},[149,178,179],{"class":155}," :",[149,181,75],{"class":163},[149,183,167],{"class":155},[149,185,171],{"class":170},[149,187,189],{"class":188},"sj4cs","COLORS",[149,191,171],{"class":170},[149,193,194],{"class":163}," header",[149,196,167],{"class":155},[149,198,199],{"class":170},"\"颜色\"",[149,201,202],{"class":163}," placeholder",[149,204,167],{"class":155},[149,206,207],{"class":170},"\"请选择颜色\"",[149,209,210],{"class":155}," \u002F>\n",[109,212,214],{"id":213},"标题说明与可访问名","标题、说明与可访问名",[14,216,217,219,220,223,224,227,228,231,232,235,236,239,240,243,244,246],{},[23,218,123],{}," 对应 WinUI ",[23,221,222],{},"Header","（",[23,225,226],{},"LineHeight 20","、下边距 8、字重 Normal），",[23,229,230],{},"description"," 对应 ",[23,233,234],{},"Description","（挂在控件下方并作为 ",[23,237,238],{},"aria-describedby","），",[23,241,242],{},"label"," 优先于 ",[23,245,123],{}," 作为可访问名。",[129,248,250,255],{"title":249},"标题与说明",[132,251,252],{"v-slot:preview":134},[253,254],"combobox-header-demo",{},[132,256,257],{"v-slot:code":134},[141,258,260],{"className":143,"code":259,"language":145,"meta":134,"style":134},"\u003CFluereCombobox\n  v-model=\"fontSize\"\n  :items=\"FONT_SIZES\"\n  header=\"正文字号\"\n  description=\"Header 同时作为缺省的可访问名\"\n  label=\"正文字号选择器\"\n\u002F>\n",[23,261,262,269,285,302,313,324,335],{"__ignoreMap":134},[149,263,264,266],{"class":151,"line":152},[149,265,156],{"class":155},[149,267,268],{"class":159},"FluereCombobox\n",[149,270,272,275,277,279,282],{"class":151,"line":271},2,[149,273,274],{"class":163},"  v-model",[149,276,167],{"class":155},[149,278,171],{"class":170},[149,280,281],{"class":155},"fontSize",[149,283,284],{"class":170},"\"\n",[149,286,288,291,293,295,297,300],{"class":151,"line":287},3,[149,289,290],{"class":155},"  :",[149,292,75],{"class":163},[149,294,167],{"class":155},[149,296,171],{"class":170},[149,298,299],{"class":188},"FONT_SIZES",[149,301,284],{"class":170},[149,303,305,308,310],{"class":151,"line":304},4,[149,306,307],{"class":163},"  header",[149,309,167],{"class":155},[149,311,312],{"class":170},"\"正文字号\"\n",[149,314,316,319,321],{"class":151,"line":315},5,[149,317,318],{"class":163},"  description",[149,320,167],{"class":155},[149,322,323],{"class":170},"\"Header 同时作为缺省的可访问名\"\n",[149,325,327,330,332],{"class":151,"line":326},6,[149,328,329],{"class":163},"  label",[149,331,167],{"class":155},[149,333,334],{"class":170},"\"正文字号选择器\"\n",[149,336,338],{"class":151,"line":337},7,[149,339,340],{"class":155},"\u002F>\n",[109,342,343],{"id":343},"选中与事件",[14,345,346,348,349,352,353,355,356,359,360,363,364,367,368,367,371,367,374,377,378,381],{},[23,347,75],{}," 的元素可以是任意类型，用 ",[23,350,351],{},"by"," 指定项身份（字段名或比较函数）、用 ",[23,354,86],{}," 指定显示与搜索文本。",[23,357,358],{},"selectionChanged"," 的载荷与 WinUI ",[23,361,362],{},"SelectionChangedEventArgs"," 对齐：",[23,365,366],{},"addedItem"," \u002F ",[23,369,370],{},"removedItem",[23,372,373],{},"addedIndex",[23,375,376],{},"removedIndex","（单选，各至多一项；无选中时下标为 ",[23,379,380],{},"-1","）。",[129,383,385,390],{"title":384},"对象项与选中事件",[132,386,387],{"v-slot:preview":134},[388,389],"combobox-object-demo",{},[132,391,392],{"v-slot:code":134},[141,393,395],{"className":143,"code":394,"language":145,"meta":134,"style":134},"\u003CFluereCombobox\n  v-model=\"city\"\n  :items=\"CITIES.map((item) => ({ value: item, text: item.name }))\"\n  by=\"id\"\n  header=\"城市（对象项 + by）\"\n  @selection-changed=\"onSelectionChanged\"\n\u002F>\n",[23,396,397,403,416,454,464,473,490],{"__ignoreMap":134},[149,398,399,401],{"class":151,"line":152},[149,400,156],{"class":155},[149,402,268],{"class":159},[149,404,405,407,409,411,414],{"class":151,"line":271},[149,406,274],{"class":163},[149,408,167],{"class":155},[149,410,171],{"class":170},[149,412,413],{"class":155},"city",[149,415,284],{"class":170},[149,417,418,420,422,424,426,429,432,435,438,442,445,449,452],{"class":151,"line":287},[149,419,290],{"class":155},[149,421,75],{"class":163},[149,423,167],{"class":155},[149,425,171],{"class":170},[149,427,428],{"class":188},"CITIES",[149,430,431],{"class":155},".",[149,433,434],{"class":163},"map",[149,436,437],{"class":155},"((",[149,439,441],{"class":440},"s4XuR","item",[149,443,444],{"class":155},") ",[149,446,448],{"class":447},"szBVR","=>",[149,450,451],{"class":155}," ({ value: item, text: item.name }))",[149,453,284],{"class":170},[149,455,456,459,461],{"class":151,"line":304},[149,457,458],{"class":163},"  by",[149,460,167],{"class":155},[149,462,463],{"class":170},"\"id\"\n",[149,465,466,468,470],{"class":151,"line":315},[149,467,307],{"class":163},[149,469,167],{"class":155},[149,471,472],{"class":170},"\"城市（对象项 + by）\"\n",[149,474,475,478,481,483,485,488],{"class":151,"line":326},[149,476,477],{"class":155},"  @",[149,479,480],{"class":163},"selection-changed",[149,482,167],{"class":155},[149,484,171],{"class":170},[149,486,487],{"class":155},"onSelectionChanged",[149,489,284],{"class":170},[149,491,492],{"class":151,"line":337},[149,493,340],{"class":155},[14,495,496,497,500,501,504],{},"需要「高亮走到哪就选到哪」（WinUI 的 ",[23,498,499],{},"SelectionChangedTrigger = Always","，字体选择器那种手感）时，传 ",[23,502,503],{},"selection-changed-trigger=\"always\"","：",[141,506,508],{"className":143,"code":507,"language":145,"meta":134,"style":134},"\u003CFluereCombobox v-model=\"font\" :items=\"FONTS\" selection-changed-trigger=\"always\" \u002F>\n",[23,509,510],{"__ignoreMap":134},[149,511,512,514,516,518,520,522,525,527,529,531,533,535,538,540,543,545,548],{"class":151,"line":152},[149,513,156],{"class":155},[149,515,160],{"class":159},[149,517,164],{"class":163},[149,519,167],{"class":155},[149,521,171],{"class":170},[149,523,524],{"class":155},"font",[149,526,171],{"class":170},[149,528,179],{"class":155},[149,530,75],{"class":163},[149,532,167],{"class":155},[149,534,171],{"class":170},[149,536,537],{"class":188},"FONTS",[149,539,171],{"class":170},[149,541,542],{"class":163}," selection-changed-trigger",[149,544,167],{"class":155},[149,546,547],{"class":170},"\"always\"",[149,549,210],{"class":155},[109,551,552],{"id":552},"键盘与文本搜索",[14,554,555,556,367,559,562],{},"键盘口径逐条对照 WinUI 的两张键位表（",[23,557,558],{},"MainKeyDown",[23,560,561],{},"PopupKeyDown","）：",[564,565,566,582],"table",{},[567,568,569],"thead",{},[570,571,572,576,579],"tr",{},[573,574,575],"th",{},"按键",[573,577,578],{},"面板收起（非可编辑）",[573,580,581],{},"面板展开",[583,584,585,608,624,637,651,670,686,697,710,721],"tbody",{},[570,586,587,596,602],{},[588,589,590,367,593],"td",{},[23,591,592],{},"↑",[23,594,595],{},"↓",[588,597,598,601],{},[18,599,600],{},"直接改选中项","（跳过禁用项）",[588,603,604,605,607],{},"移动高亮（",[23,606,102],{}," 下不改选中）",[570,609,610,618,621],{},[588,611,612,367,615],{},[23,613,614],{},"Home",[23,616,617],{},"End",[588,619,620],{},"选首个 \u002F 末个可选项",[588,622,623],{},"高亮首个 \u002F 末个",[570,625,626,631,634],{},[588,627,628],{},[23,629,630],{},"Enter",[588,632,633],{},"展开面板",[588,635,636],{},"提交高亮项并收起",[570,638,639,644,646],{},[588,640,641],{},[23,642,643],{},"Space",[588,645,633],{},[588,647,648,649],{},"等价于 ",[23,650,630],{},[570,652,653,664,667],{},[588,654,655,367,658,661,662],{},[23,656,657],{},"Ctrl",[23,659,660],{},"Cmd"," + ",[23,663,630],{},[588,665,666],{},"—",[588,668,669],{},"取消已选中项的选中",[570,671,672,681,683],{},[588,673,674,661,677,367,679],{},[23,675,676],{},"Alt",[23,678,592],{},[23,680,595],{},[588,682,633],{},[588,684,685],{},"收起面板",[570,687,688,693,695],{},[588,689,690],{},[23,691,692],{},"F4",[588,694,633],{},[588,696,685],{},[570,698,699,704,707],{},[588,700,701],{},[23,702,703],{},"Escape",[588,705,706],{},"不处理（冒泡给上层）",[588,708,709],{},"收起面板，不改选中项",[570,711,712,715,718],{},[588,713,714],{},"字符键",[588,716,717],{},"前缀搜索并直接选中命中项",[588,719,720],{},"同上（弹层把字符冒泡回控件）",[570,722,723,728,731],{},[588,724,725],{},[23,726,727],{},"Tab",[588,729,730],{},"焦点照常离开",[588,732,733],{},"收起面板，焦点照常离开",[14,735,736,737,740,741,744,745,748,749,752,753,756,757,760],{},"文本搜索与 WinUI 同口径：项文本先 ",[23,738,739],{},"TrimStart(' ')"," 再",[18,742,743],{},"忽略大小写做前缀匹配","（不做子串 \u002F 模糊匹配）；两次按键间隔 ≤ ",[18,746,747],{},"1000ms"," 时搜索串累积，超过则另起一次；新搜索串从「当前项 + 1」起",[18,750,751],{},"环状","扫描，命中即直接改选中项。",[23,754,755],{},"text-search-enabled=\"false\""," 可整体关掉（对应 ",[23,758,759],{},"IsTextSearchEnabled","）。焦点在控件上、面板收起时，滚轮也会改选中项（WinUI 只在聚焦且收起时响应）。",[129,762,764,769],{"title":763},"长列表与文本搜索",[132,765,766],{"v-slot:preview":134},[767,768],"combobox-long-list-demo",{},[132,770,771],{"v-slot:code":134},[141,772,774],{"className":143,"code":773,"language":145,"meta":134,"style":134},"\u003CFluereCombobox\n  v-model=\"state\"\n  :items=\"STATES\"\n  header=\"州（输入 w 试试文本搜索）\"\n  placeholder=\"选择或直接输入首字母\"\n  :max-drop-down-height=\"200\"\n\u002F>\n",[23,775,776,782,795,810,819,829,845],{"__ignoreMap":134},[149,777,778,780],{"class":151,"line":152},[149,779,156],{"class":155},[149,781,268],{"class":159},[149,783,784,786,788,790,793],{"class":151,"line":271},[149,785,274],{"class":163},[149,787,167],{"class":155},[149,789,171],{"class":170},[149,791,792],{"class":155},"state",[149,794,284],{"class":170},[149,796,797,799,801,803,805,808],{"class":151,"line":287},[149,798,290],{"class":155},[149,800,75],{"class":163},[149,802,167],{"class":155},[149,804,171],{"class":170},[149,806,807],{"class":188},"STATES",[149,809,284],{"class":170},[149,811,812,814,816],{"class":151,"line":304},[149,813,307],{"class":163},[149,815,167],{"class":155},[149,817,818],{"class":170},"\"州（输入 w 试试文本搜索）\"\n",[149,820,821,824,826],{"class":151,"line":315},[149,822,823],{"class":163},"  placeholder",[149,825,167],{"class":155},[149,827,828],{"class":170},"\"选择或直接输入首字母\"\n",[149,830,831,833,836,838,840,843],{"class":151,"line":326},[149,832,290],{"class":155},[149,834,835],{"class":163},"max-drop-down-height",[149,837,167],{"class":155},[149,839,171],{"class":170},[149,841,842],{"class":188},"200",[149,844,284],{"class":170},[149,846,847],{"class":151,"line":337},[149,848,340],{"class":155},[14,850,851,852,855,856,859],{},"面板最大高度缺省 504px（WinUI ",[23,853,854],{},"DefaultComboBoxStyle"," 的 ",[23,857,858],{},"MaxDropDownHeight","，约 15 项），超出后列表内滚动。",[109,861,862],{"id":862},"可编辑态",[14,864,865,219,868,871,872,875,876,367,878,881],{},[23,866,867],{},"editable",[23,869,870],{},"IsEditable","：输入框可输入自定义值，",[18,873,874],{},"输入不会过滤列表","（WinUI 的可编辑 ComboBox 只做行内补全，不过滤），面板仍由箭头热区 \u002F ",[23,877,692],{},[23,879,880],{},"Alt+↓"," 打开。",[42,883,884,894,909,927,938],{},[45,885,886,889,890,893],{},[18,887,888],{},"行内补全","：输入前缀命中某项时补全为该项文本，并选中补全部分（WinUI ",[23,891,892],{},"UpdateEditableTextBox(selectText: true)","），继续输入即替换；",[45,895,896,901,902,905,906,67],{},[18,897,898,900],{},[23,899,630],{}," \u002F 失焦提交","：文本匹配已有项 → 选中该项；否则抛 ",[23,903,904],{},"textSubmitted","，并按 WinUI 的缺省行为把选中项清空、",[18,907,908],{},"保留文本",[45,910,911,918,919,922,923,926],{},[18,912,913,855,915],{},[23,914,904],{},[23,916,917],{},"handled","：置 ",[23,920,921],{},"true"," 即等同 WinUI ",[23,924,925],{},"e.Handled = true","，组件不再改动选中项（便于校验后回填）；",[45,928,929,933,934,937],{},[18,930,931],{},[23,932,703],{},"：回滚文本到当前选中项（WinUI ",[23,935,936],{},"CommitRevertEditableSearch(restoreValue: true)","）；",[45,939,940,941,944,945,381],{},"文本可用 ",[23,942,943],{},"v-model:text"," 受控（对应 WinUI ",[23,946,947],{},"Text",[129,949,950,955],{"title":862},[132,951,952],{"v-slot:preview":134},[953,954],"combobox-editable-demo",{},[132,956,957],{"v-slot:code":134},[141,958,960],{"className":143,"code":959,"language":145,"meta":134,"style":134},"\u003CFluereCombobox\n  v-model=\"name\"\n  :items=\"RECENT_NAMES\"\n  editable\n  header=\"名称（可自定义）\"\n  placeholder=\"输入或选择\"\n  @text-submitted=\"onTextSubmitted\"\n\u002F>\n",[23,961,962,968,981,996,1001,1010,1019,1035],{"__ignoreMap":134},[149,963,964,966],{"class":151,"line":152},[149,965,156],{"class":155},[149,967,268],{"class":159},[149,969,970,972,974,976,979],{"class":151,"line":271},[149,971,274],{"class":163},[149,973,167],{"class":155},[149,975,171],{"class":170},[149,977,978],{"class":155},"name",[149,980,284],{"class":170},[149,982,983,985,987,989,991,994],{"class":151,"line":287},[149,984,290],{"class":155},[149,986,75],{"class":163},[149,988,167],{"class":155},[149,990,171],{"class":170},[149,992,993],{"class":188},"RECENT_NAMES",[149,995,284],{"class":170},[149,997,998],{"class":151,"line":304},[149,999,1000],{"class":163},"  editable\n",[149,1002,1003,1005,1007],{"class":151,"line":315},[149,1004,307],{"class":163},[149,1006,167],{"class":155},[149,1008,1009],{"class":170},"\"名称（可自定义）\"\n",[149,1011,1012,1014,1016],{"class":151,"line":326},[149,1013,823],{"class":163},[149,1015,167],{"class":155},[149,1017,1018],{"class":170},"\"输入或选择\"\n",[149,1020,1021,1023,1026,1028,1030,1033],{"class":151,"line":337},[149,1022,477],{"class":155},[149,1024,1025],{"class":163},"text-submitted",[149,1027,167],{"class":155},[149,1029,171],{"class":170},[149,1031,1032],{"class":155},"onTextSubmitted",[149,1034,284],{"class":170},[149,1036,1038],{"class":151,"line":1037},8,[149,1039,340],{"class":155},[109,1041,1042],{"id":1042},"自定义下拉项",[14,1044,1045,1046,1049,1050,1053,1054,1057],{},"用 ",[23,1047,1048],{},"#item"," 插槽覆盖行内容（对应 WinUI ",[23,1051,1052],{},"ItemTemplate","），插槽参数是 ",[23,1055,1056],{},"{ item, index }","。选中指示条、内边距、圆角与状态色仍由组件负责。",[129,1059,1060,1065],{"title":1042},[132,1061,1062],{"v-slot:preview":134},[1063,1064],"combobox-custom-item-demo",{},[132,1066,1067],{"v-slot:code":134},[141,1068,1070],{"className":143,"code":1069,"language":145,"meta":134,"style":134},"\u003CFluereCombobox v-model=\"color\" :items=\"COLORS\" header=\"强调色\">\n  \u003Ctemplate #item=\"{ item }\">\n    \u003Cspan class=\"flex items-center gap-2\">\n      \u003Cspan class=\"inline-block w-4 h-4 rounded-fluent-sm\" :style=\"{ backgroundColor: item.value }\" \u002F>\n      {{ item.text }}\n    \u003C\u002Fspan>\n  \u003C\u002Ftemplate>\n\u003C\u002FFluereCombobox>\n",[23,1071,1072,1111,1116,1121,1126,1131,1136,1141],{"__ignoreMap":134},[149,1073,1074,1076,1078,1080,1082,1084,1087,1089,1091,1093,1095,1097,1099,1101,1103,1105,1108],{"class":151,"line":152},[149,1075,156],{"class":155},[149,1077,160],{"class":159},[149,1079,164],{"class":163},[149,1081,167],{"class":155},[149,1083,171],{"class":170},[149,1085,1086],{"class":155},"color",[149,1088,171],{"class":170},[149,1090,179],{"class":155},[149,1092,75],{"class":163},[149,1094,167],{"class":155},[149,1096,171],{"class":170},[149,1098,189],{"class":188},[149,1100,171],{"class":170},[149,1102,194],{"class":163},[149,1104,167],{"class":155},[149,1106,1107],{"class":170},"\"强调色\"",[149,1109,1110],{"class":155},">\n",[149,1112,1113],{"class":151,"line":271},[149,1114,1115],{"class":155},"  \u003Ctemplate #item=\"{ item }\">\n",[149,1117,1118],{"class":151,"line":287},[149,1119,1120],{"class":155},"    \u003Cspan class=\"flex items-center gap-2\">\n",[149,1122,1123],{"class":151,"line":304},[149,1124,1125],{"class":155},"      \u003Cspan class=\"inline-block w-4 h-4 rounded-fluent-sm\" :style=\"{ backgroundColor: item.value }\" \u002F>\n",[149,1127,1128],{"class":151,"line":315},[149,1129,1130],{"class":155},"      {{ item.text }}\n",[149,1132,1133],{"class":151,"line":326},[149,1134,1135],{"class":155},"    \u003C\u002Fspan>\n",[149,1137,1138],{"class":151,"line":337},[149,1139,1140],{"class":155},"  \u003C\u002Ftemplate>\n",[149,1142,1143,1146,1148],{"class":151,"line":1037},[149,1144,1145],{"class":155},"\u003C\u002F",[149,1147,160],{"class":159},[149,1149,1110],{"class":155},[109,1151,1152],{"id":1152},"禁用",[14,1154,1155,219,1158,1161,1162,231,1164,1167],{},[23,1156,1157],{},"disabled",[23,1159,1160],{},"IsEnabled = false","（填充 \u002F 前景 \u002F 箭头 \u002F 指示条全走禁用档，且不响应指针与键盘）；单个选项的 ",[23,1163,1157],{},[23,1165,1166],{},"ComboBoxItem.IsEnabled = false","，不参与方向键选区与文本搜索。",[129,1169,1171,1176],{"title":1170},"禁用状态",[132,1172,1173],{"v-slot:preview":134},[1174,1175],"combobox-disabled-demo",{},[132,1177,1178],{"v-slot:code":134},[141,1179,1181],{"className":143,"code":1180,"language":145,"meta":134,"style":134},"\u003CFluereCombobox v-model=\"plan\" :items=\"PLANS\" header=\"可选中\" \u002F>\n\u003CFluereCombobox v-model=\"locked\" :items=\"PLANS\" disabled header=\"整体禁用\" \u002F>\n",[23,1182,1183,1222],{"__ignoreMap":134},[149,1184,1185,1187,1189,1191,1193,1195,1198,1200,1202,1204,1206,1208,1211,1213,1215,1217,1220],{"class":151,"line":152},[149,1186,156],{"class":155},[149,1188,160],{"class":159},[149,1190,164],{"class":163},[149,1192,167],{"class":155},[149,1194,171],{"class":170},[149,1196,1197],{"class":155},"plan",[149,1199,171],{"class":170},[149,1201,179],{"class":155},[149,1203,75],{"class":163},[149,1205,167],{"class":155},[149,1207,171],{"class":170},[149,1209,1210],{"class":188},"PLANS",[149,1212,171],{"class":170},[149,1214,194],{"class":163},[149,1216,167],{"class":155},[149,1218,1219],{"class":170},"\"可选中\"",[149,1221,210],{"class":155},[149,1223,1224,1226,1228,1230,1232,1234,1237,1239,1241,1243,1245,1247,1249,1251,1254,1256,1258,1261],{"class":151,"line":271},[149,1225,156],{"class":155},[149,1227,160],{"class":159},[149,1229,164],{"class":163},[149,1231,167],{"class":155},[149,1233,171],{"class":170},[149,1235,1236],{"class":155},"locked",[149,1238,171],{"class":170},[149,1240,179],{"class":155},[149,1242,75],{"class":163},[149,1244,167],{"class":155},[149,1246,171],{"class":170},[149,1248,1210],{"class":188},[149,1250,171],{"class":170},[149,1252,1253],{"class":163}," disabled",[149,1255,194],{"class":163},[149,1257,167],{"class":155},[149,1259,1260],{"class":170},"\"整体禁用\"",[149,1262,210],{"class":155},[109,1264,1265],{"id":1265},"表单提交",[14,1267,1268,1269,1272,1273,1275,1276,1279,1280,1283,1284,1287],{},"位于 ",[23,1270,1271],{},"\u003Cform>"," 内并传 ",[23,1274,978],{}," 时，会补一个隐藏的原生 ",[23,1277,1278],{},"\u003Cinput type=\"hidden\">","，提交 ",[23,1281,1282],{},"name=value","（无选中时提交空串），对应 WinUI ",[23,1285,1286],{},"SelectedValue"," 的用法。",[129,1289,1290,1295],{"title":1265},[132,1291,1292],{"v-slot:preview":134},[1293,1294],"combobox-form-demo",{},[132,1296,1297],{"v-slot:code":134},[141,1298,1300],{"className":143,"code":1299,"language":145,"meta":134,"style":134},"\u003Cform @submit.prevent=\"onSubmit\">\n  \u003CFluereCombobox v-model=\"shipping\" :items=\"SHIPPING\" name=\"shipping\" header=\"配送方式\" \u002F>\n  \u003CFluereButton type=\"submit\" appearance=\"primary\">提交\u003C\u002FFluereButton>\n\u003C\u002Fform>\n",[23,1301,1302,1331,1336,1341],{"__ignoreMap":134},[149,1303,1304,1306,1309,1312,1315,1317,1320,1322,1324,1327,1329],{"class":151,"line":152},[149,1305,156],{"class":155},[149,1307,1308],{"class":159},"form",[149,1310,1311],{"class":155}," @",[149,1313,1314],{"class":163},"submit",[149,1316,431],{"class":155},[149,1318,1319],{"class":163},"prevent",[149,1321,167],{"class":155},[149,1323,171],{"class":170},[149,1325,1326],{"class":155},"onSubmit",[149,1328,171],{"class":170},[149,1330,1110],{"class":155},[149,1332,1333],{"class":151,"line":271},[149,1334,1335],{"class":155},"  \u003CFluereCombobox v-model=\"shipping\" :items=\"SHIPPING\" name=\"shipping\" header=\"配送方式\" \u002F>\n",[149,1337,1338],{"class":151,"line":287},[149,1339,1340],{"class":155},"  \u003CFluereButton type=\"submit\" appearance=\"primary\">提交\u003C\u002FFluereButton>\n",[149,1342,1343,1345,1347],{"class":151,"line":304},[149,1344,1145],{"class":155},[149,1346,1308],{"class":159},[149,1348,1110],{"class":155},[109,1350,1352],{"id":1351},"api","API",[564,1354,1355,1371],{},[567,1356,1357],{},[570,1358,1359,1362,1365,1368],{},[573,1360,1361],{},"属性（Props）",[573,1363,1364],{},"类型",[573,1366,1367],{},"默认",[573,1369,1370],{},"说明",[583,1372,1373,1400,1418,1441,1467,1486,1506,1525,1547,1566,1587,1607,1626,1648,1665,1683,1705,1725,1746],{},[570,1374,1375,1379,1384,1388],{},[588,1376,1377],{},[23,1378,60],{},[588,1380,1381],{},[23,1382,1383],{},"unknown | null",[588,1385,1386],{},[23,1387,666],{},[588,1389,1390,1391,937,1393,1395,1396,1399],{},"当前选中值（",[23,1392,116],{},[23,1394,52],{}," 表示未选中（WinUI ",[23,1397,1398],{},"SelectedItem","）",[570,1401,1402,1407,1411,1415],{},[588,1403,1404],{},[23,1405,1406],{},"defaultValue",[588,1408,1409],{},[23,1410,1383],{},[588,1412,1413],{},[23,1414,52],{},[588,1416,1417],{},"非受控初始选中值",[570,1419,1420,1424,1429,1434],{},[588,1421,1422],{},[23,1423,75],{},[588,1425,1426],{},[23,1427,1428],{},"FluereComboboxItem[]",[588,1430,1431],{},[23,1432,1433],{},"[]",[588,1435,1436,1437,562,1439],{},"选项数据（WinUI ",[23,1438,78],{},[23,1440,82],{},[570,1442,1443,1448,1453,1457],{},[588,1444,1445],{},[23,1446,1447],{},"open",[588,1449,1450],{},[23,1451,1452],{},"boolean",[588,1454,1455],{},[23,1456,666],{},[588,1458,1459,1460,1463,1464,1399],{},"面板展开状态（",[23,1461,1462],{},"v-model:open","，WinUI ",[23,1465,1466],{},"IsDropDownOpen",[570,1468,1469,1474,1478,1483],{},[588,1470,1471],{},[23,1472,1473],{},"defaultOpen",[588,1475,1476],{},[23,1477,1452],{},[588,1479,1480],{},[23,1481,1482],{},"false",[588,1484,1485],{},"非受控初始展开状态",[570,1487,1488,1492,1496,1500],{},[588,1489,1490],{},[23,1491,1157],{},[588,1493,1494],{},[23,1495,1452],{},[588,1497,1498],{},[23,1499,1482],{},[588,1501,1502,1503,1399],{},"是否禁用（WinUI ",[23,1504,1505],{},"IsEnabled",[570,1507,1508,1512,1516,1520],{},[588,1509,1510],{},[23,1511,867],{},[588,1513,1514],{},[23,1515,1452],{},[588,1517,1518],{},[23,1519,1482],{},[588,1521,1522,1523,1399],{},"可编辑态（WinUI ",[23,1524,870],{},[570,1526,1527,1531,1536,1540],{},[588,1528,1529],{},[23,1530,86],{},[588,1532,1533],{},[23,1534,1535],{},"string",[588,1537,1538],{},[23,1539,666],{},[588,1541,1542,1543,1463,1545,1399],{},"可编辑态文本（",[23,1544,943],{},[23,1546,947],{},[570,1548,1549,1554,1558,1563],{},[588,1550,1551],{},[23,1552,1553],{},"defaultText",[588,1555,1556],{},[23,1557,1535],{},[588,1559,1560],{},[23,1561,1562],{},"''",[588,1564,1565],{},"可编辑态非受控初始文本",[570,1567,1568,1572,1576,1580],{},[588,1569,1570],{},[23,1571,127],{},[588,1573,1574],{},[23,1575,1535],{},[588,1577,1578],{},[23,1579,666],{},[588,1581,1582,1583,1586],{},"占位符（WinUI ",[23,1584,1585],{},"PlaceholderText","），仅未选中时显示",[570,1588,1589,1593,1597,1601],{},[588,1590,1591],{},[23,1592,123],{},[588,1594,1595],{},[23,1596,1535],{},[588,1598,1599],{},[23,1600,666],{},[588,1602,1603,1604,1606],{},"顶部标题（WinUI ",[23,1605,222],{},"），同时是缺省可访问名",[570,1608,1609,1613,1617,1621],{},[588,1610,1611],{},[23,1612,242],{},[588,1614,1615],{},[23,1616,1535],{},[588,1618,1619],{},[23,1620,666],{},[588,1622,1623,1624,1399],{},"可访问名称（优先于 ",[23,1625,123],{},[570,1627,1628,1632,1636,1640],{},[588,1629,1630],{},[23,1631,230],{},[588,1633,1634],{},[23,1635,1535],{},[588,1637,1638],{},[23,1639,666],{},[588,1641,1642,1643,1645,1646],{},"控件下方说明（WinUI ",[23,1644,234],{},"），并作为 ",[23,1647,238],{},[570,1649,1650,1654,1658,1662],{},[588,1651,1652],{},[23,1653,978],{},[588,1655,1656],{},[23,1657,1535],{},[588,1659,1660],{},[23,1661,666],{},[588,1663,1664],{},"表单提交名，配合隐藏原生 input",[570,1666,1667,1671,1676,1680],{},[588,1668,1669],{},[23,1670,351],{},[588,1672,1673],{},[23,1674,1675],{},"string | ((a, b) => boolean)",[588,1677,1678],{},[23,1679,666],{},[588,1681,1682],{},"对象项的项身份比较",[570,1684,1685,1690,1695,1700],{},[588,1686,1687],{},[23,1688,1689],{},"maxDropDownHeight",[588,1691,1692],{},[23,1693,1694],{},"number",[588,1696,1697],{},[23,1698,1699],{},"504",[588,1701,1702,1703,1399],{},"面板最大高度（WinUI ",[23,1704,858],{},[570,1706,1707,1712,1716,1720],{},[588,1708,1709],{},[23,1710,1711],{},"textSearchEnabled",[588,1713,1714],{},[23,1715,1452],{},[588,1717,1718],{},[23,1719,921],{},[588,1721,1722,1723,1399],{},"是否启用前缀搜索（WinUI ",[23,1724,759],{},[570,1726,1727,1731,1736,1741],{},[588,1728,1729],{},[23,1730,97],{},[588,1732,1733],{},[23,1734,1735],{},"'committed' | 'always'",[588,1737,1738],{},[23,1739,1740],{},"'committed'",[588,1742,1743,1744,1399],{},"提交时机（WinUI ",[23,1745,106],{},[570,1747,1748,1753,1758,1762],{},[588,1749,1750],{},[23,1751,1752],{},"dir",[588,1754,1755],{},[23,1756,1757],{},"'ltr' | 'rtl'",[588,1759,1760],{},[23,1761,666],{},[588,1763,1764],{},"阅读方向",[564,1766,1767,1779],{},[567,1768,1769],{},[570,1770,1771,1774,1777],{},[573,1772,1773],{},"事件（Events）",[573,1775,1776],{},"载荷",[573,1778,1370],{},[583,1780,1781,1797,1813,1829,1846,1860,1874],{},[570,1782,1783,1788,1792],{},[588,1784,1785],{},[23,1786,1787],{},"update:modelValue",[588,1789,1790],{},[23,1791,1383],{},[588,1793,1794,1795,1399],{},"选中值变化（",[23,1796,116],{},[570,1798,1799,1804,1808],{},[588,1800,1801],{},[23,1802,1803],{},"update:open",[588,1805,1806],{},[23,1807,1452],{},[588,1809,1810,1811,1399],{},"面板展开状态变化（",[23,1812,1462],{},[570,1814,1815,1820,1824],{},[588,1816,1817],{},[23,1818,1819],{},"update:text",[588,1821,1822],{},[23,1823,1535],{},[588,1825,1826,1827,1399],{},"可编辑态文本变化（",[23,1828,943],{},[570,1830,1831,1835,1840],{},[588,1832,1833],{},[23,1834,358],{},[588,1836,1837],{},[23,1838,1839],{},"{ addedItem, removedItem, addedIndex, removedIndex }",[588,1841,1842,1843],{},"对应 WinUI ",[23,1844,1845],{},"SelectionChanged",[570,1847,1848,1853,1855],{},[588,1849,1850],{},[23,1851,1852],{},"dropDownOpened",[588,1854,666],{},[588,1856,1842,1857],{},[23,1858,1859],{},"DropDownOpened",[570,1861,1862,1867,1869],{},[588,1863,1864],{},[23,1865,1866],{},"dropDownClosed",[588,1868,666],{},[588,1870,1842,1871],{},[23,1872,1873],{},"DropDownClosed",[570,1875,1876,1880,1885],{},[588,1877,1878],{},[23,1879,904],{},[588,1881,1882],{},[23,1883,1884],{},"{ text: string, handled: boolean }",[588,1886,1842,1887,1890],{},[23,1888,1889],{},"TextSubmitted","（可编辑态）",[564,1892,1893,1902],{},[567,1894,1895],{},[570,1896,1897,1900],{},[573,1898,1899],{},"插槽（Slots）",[573,1901,1370],{},[583,1903,1904,1918,1932,1942],{},[570,1905,1906,1910],{},[588,1907,1908],{},[23,1909,441],{},[588,1911,1912,1913,1915,1916],{},"下拉项内容（",[23,1914,1056],{},"），对应 WinUI ",[23,1917,1052],{},[570,1919,1920,1924],{},[588,1921,1922],{},[23,1923,123],{},[588,1925,1926,1927,367,1929,1399],{},"顶部标题行（WinUI ",[23,1928,222],{},[23,1930,1931],{},"HeaderTemplate",[570,1933,1934,1938],{},[588,1935,1936],{},[23,1937,230],{},[588,1939,1642,1940,1399],{},[23,1941,234],{},[570,1943,1944,1949],{},[588,1945,1946],{},[23,1947,1948],{},"empty",[588,1950,1951],{},"选项为空时的内容（WinUI 没有空态文案，不提供即渲染空面板）",[1953,1954,1955],"blockquote",{},[14,1956,1957,1958,1961,1962,367,1965,367,1968,1971,1972,1975,1976,1979,1980,1983,1984,661,1987,1990,1991,1994,1995,1998],{},"无障碍：输入框带 ",[23,1959,1960],{},"role=\"combobox\"","、",[23,1963,1964],{},"aria-expanded",[23,1966,1967],{},"aria-controls",[23,1969,1970],{},"aria-activedescendant","，非可编辑态补 ",[23,1973,1974],{},"readonly"," 与 ",[23,1977,1978],{},"aria-autocomplete=\"none\"","，可编辑态为 ",[23,1981,1982],{},"aria-autocomplete=\"list\"","；下拉项是 ",[23,1985,1986],{},"role=\"option\"",[23,1988,1989],{},"aria-selected","，禁用项带 ",[23,1992,1993],{},"aria-disabled","。焦点始终停在控件上（",[23,1996,1997],{},"TabNavigation=\"Once\""," 语义），下拉项不进入 Tab 序列。",[1953,2000,2001,2004],{},[14,2002,2003],{},"与 WinUI 的差异（均为 Web 侧近似，逐条记录）：",[2005,2006,2007,2024,2058,2080,2109,2120,2137],"ol",{},[45,2008,2009,2012,2013,661,2016,2019,2020,2023],{},[18,2010,2011],{},"Acrylic 表面","：Fluent 令牌集中没有材质令牌，浮层用 ",[23,2014,2015],{},"colorNeutralBackground1",[23,2017,2018],{},"shadow16"," 近似（与 NumberBox 紧凑浮层一致），未复刻 ",[23,2021,2022],{},"AcrylicInAppFillColorDefaultBrush"," 的模糊配方。",[45,2025,2026,2029,2030,2033,2034,2037,2038,2041,2042,2045,2046,2049,2050,2053,2054,2057],{},[18,2027,2028],{},"浮层开启动画","：以 ",[23,2031,2032],{},"clip-path"," 从",[18,2035,2036],{},"选中项中线向上下两侧展开","近似 ",[23,2039,2040],{},"SplitOpenThemeAnimation","（无选中时贴触发控件一侧；250ms \u002F ",[23,2043,2044],{},"0,0,0,1","）——面板先收拢成一条缝、实测选中项位置写入 CSS 变量后再起播；",[18,2047,2048],{},"关闭动画省略","——reka 的 ",[23,2051,2052],{},"Presence"," 会立即卸载内容，以保住 ",[23,2055,2056],{},"aria-hidden"," 语义正确。",[45,2059,2060,2063,2064,2067,2068,2071,2072,2075,2076,2079],{},[18,2061,2062],{},"箭头按下态","：WinUI 3 Gallery 的箭头按下是",[18,2065,2066],{},"轻微下沉（不翻转）","，这里以 ",[23,2069,2070],{},"translateY(1px)","（进 ",[23,2073,2074],{},"durationFast"," \u002F 回 ",[23,2077,2078],{},"durationNormal","）近似。",[45,2081,2082,2085,2086,2089,2090,2093,2094,2097,2098,2101,2102,1975,2105,2108],{},[18,2083,2084],{},"焦点矩形","：WinUI 用 ",[23,2087,2088],{},"FocusStrokeColorOuter","（浅色 ",[23,2091,2092],{},"#E4000000"," \u002F 深色白），令牌集中对应 ",[23,2095,2096],{},"colorStrokeFocus2","；组件库其余控件目前用 ",[23,2099,2100],{},"colorCompoundBrandStroke","，本组件按 WinUI 源取色。仅键盘 \u002F 程序化聚焦显示焦点矩形与 3×16 品牌色指示条（对应 WinUI ",[23,2103,2104],{},"Focused",[23,2106,2107],{},"PointerFocused"," 的区分）。",[45,2110,2111,2119],{},[18,2112,2113,367,2116],{},[23,2114,2115],{},"PageUp",[23,2117,2118],{},"PageDown","：WinUI 在展开态按页移动高亮，这里只吃掉按键（阻止页面滚动），不移动高亮。",[45,2121,2122,2129,2130,2133,2134,2136],{},[18,2123,2124,2125,2128],{},"项 ",[23,2126,2127],{},"value"," 不能是空字符串","：reka 底座用它表示「清空选中」，故 ",[23,2131,2132],{},"value: ''"," 会被拒绝（WinUI 无此限制）；需要空串语义时用 ",[23,2135,52],{}," 或哨兵值。",[45,2138,2139],{},"文本超长时输入框用省略号截断（WinUI 是直接裁切）。",[2141,2142,2143],"style",{},"html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .s9eBZ, html code.shiki .s9eBZ{--shiki-default:#22863A;--shiki-dark:#85E89D}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .s4XuR, html code.shiki .s4XuR{--shiki-default:#E36209;--shiki-dark:#FFAB70}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}",{"title":134,"searchDepth":271,"depth":271,"links":2145},[2146,2147,2148,2149,2150,2151,2152,2153,2154],{"id":111,"depth":271,"text":111},{"id":213,"depth":271,"text":214},{"id":343,"depth":271,"text":343},{"id":552,"depth":271,"text":552},{"id":862,"depth":271,"text":862},{"id":1042,"depth":271,"text":1042},{"id":1152,"depth":271,"text":1152},{"id":1265,"depth":271,"text":1265},{"id":1351,"depth":271,"text":1352},"下拉选择框，用于从一组单行文本选项中选中一项，支持文本搜索与可编辑自定义值。","md",{},{"title":5},true,"\u002Fcomponents\u002Fcombobox",{"title":5,"description":2155},"components\u002Fcombobox","pWRxH-8RDbQcchnYUfz9KG50P4XyQ7kO4tWo26x3G5I",null,1791802960540]