element_getSize
Retrieve width and height measurements for elements in WeChat mini programs, including components using innerSelector for internal element sizing.
Instructions
获取元素大小(宽度和高度)。如需获取自定义组件内部元素的大小，请使用 innerSelector 参数：selector 设为组件 ID 选择器(如 #my-component)，innerSelector 设为组件内部元素的选择器。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| connection | No | ||
| selector | Yes | ||
| innerSelector | No |
Implementation Reference
- src/tools/element.ts:350-386 (handler)The handler implementation for the 'element_getSize' tool. Resolves the target element and retrieves its size (width and height) using the element.size() method.function createGetElementSizeTool(manager: WeappAutomatorManager): AnyTool { return { name: "element_getSize", description: "获取元素大小(宽度和高度)。如需获取自定义组件内部元素的大小，请使用 innerSelector 参数：selector 设为组件 ID 选择器(如 #my-component)，innerSelector 设为组件内部元素的选择器。", parameters: getElementSizeParameters, execute: async (rawArgs, context: ToolContext) => { const args = getElementSizeParameters.parse(rawArgs ?? {}); return manager.withPage( context.log, { overrides: args.connection }, async (page) => { const element = await resolveElement( page, args.selector, args.innerSelector ); if (typeof element.size !== "function") { throw new UserError( `元素 "${args.selector}" 不支持获取大小。` ); } const size = await element.size(); return toTextResult( formatJson({ selector: args.selector, innerSelector: args.innerSelector ?? null, width: toSerializableValue(size.width), height: toSerializableValue(size.height), }) ); } ); }, }; }
- src/tools/element.ts:59-62 (schema)Zod schema defining the input parameters for the element_getSize tool: selector (required), innerSelector (optional), and inherited connection fields.const getElementSizeParameters = connectionContainerSchema.extend({ selector: z.string().trim().min(1), innerSelector: z.string().trim().min(1).optional(), });
- src/tools/element.ts:70-83 (registration)Registration of the element_getSize tool within the createElementTools function, which returns an array of all element-related tools.export function createElementTools( manager: WeappAutomatorManager ): AnyTool[] { return [ createTapElementTool(manager), createInputTextTool(manager), createCallElementMethodTool(manager), createGetElementDataTool(manager), createSetElementDataTool(manager), createGetInnerElementTool(manager), createGetInnerElementsTool(manager), createGetElementSizeTool(manager), createGetElementWxmlTool(manager), ];
- src/tools.ts:7-13 (registration)Top-level registration aggregator that includes element tools (containing element_getSize) via createElementTools.export function createTools(manager: WeappAutomatorManager): AnyTool[] { return [ ...createApplicationTools(manager), ...createPageTools(manager), ...createElementTools(manager), ]; }