LetXPath/install.html at master · ortoniKC/LetXPath · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <link rel="shortcut icon" href="./assets/16.png" type="image/x-icon">
    <link rel="stylesheet" href="./app/styles/main.css">
    <title>How to use LetXPath</title>
</head>

<body class="bg-dark">
    <div class="container">
        <div class="columns">
            <div class="column col-3"></div>

            <div class="column col-6">
                <div class="hero bg-primary">
                    <div class="hero-body">
                        <h1 class="title">How to Use LetXPath Extension</h1>
                        <h2>Please restart your browser to use LetXPath</h2>
                    </div>
                </div>
                <div class="content mt-2">
                    <h3>Step 1: Open LetXPath</h3>
                    <ol>
                        <li><strong>Open a Web Page</strong>: Navigate to any webpage where you want to use the
                            extension to
                            find XPath expressions.</li>
                        <li><strong>Activate LetXPath</strong>:
                            <ul>
                                <li>Click on the LetXPath icon in the Chrome toolbar.</li>
                                <li>This will open the LetXPath panel on the right side of the webpage.</li>
                            </ul>
                        </li>
                    </ol>

                    <h3>Step 2: Inspect Elements</h3>
                    <ol>
                        <li><strong>Select an Element</strong>:
                            <ul>
                                <li>Click on an element to lock its XPath.</li>
                                <li>The XPath will be shown in the LetXPath panel.</li>
                            </ul>
                        </li>
                    </ol>

                    <h3>Step 3: Search/Edit XPath</h3>
                    <p><strong>Edit XPath</strong> (Optional):
                    <ul>
                        <li>You can manually edit the XPath expression in the LetXPath panel.</li>
                        <li>The panel will show the number of matching elements and highlights</li>
                    </ul>
                    </p>

                    <h3>Step 4: Copy XPath</h3>
                    <ol>
                        <li><strong>Copy the XPath</strong>:
                            <ul>
                                <li>Click on the <strong>Locators</strong> expression in the LetXPath panel.</li>
                                <li>This will copy the XPath to your clipboard.</li>
                            </ul>
                        </li>
                    </ol>

                    <h3>Step 5: Use the snippets</h3>
                    <ol>
                        <li><strong>Use in Automation Scripts</strong>:
                            <ul>
                                <li>Click on the dropdown next to the Locators (e.g., Selenium, Playwright).</li>
                                <li>On selected action snippets copied to clipboard.</li>
                            </ul>
                        </li>
                    </ol>

                    <h3>Step 6: Axes XPath</h3>
                    <ol>
                        <li><strong>Toggle XPath Types</strong>:
                            <ul>
                                <li>Right click on the webpage to select the Parent element, then the child element</li>
                                <li>You can toggle with different Axes combination</li>
                            </ul>
                        </li>
                    </ol>
                    <h3>Step 7: Convert XPath to CSS</h3>
                    <ol>
                        <li><strong>Open the tools tab</strong>:
                            <ul>
                                <li>Click the conversion</li>
                                <li>Enter XPath</li>
                                <li>Click Convert</li>
                                <li>Number of matching elements will be shown with highlights</li>
                            </ul>
                        </li>
                    </ol>
                    <h3>Step 8: Deactivate LetXPath</h3>
                    <ol>
                        <li><strong>Close the Panel</strong>:
                            <ul>
                                <li>Click on the close button on the LetXPath panel or click on the LetXPath icon again
                                    to
                                    deactivate the extension.</li>
                            </ul>
                        </li>
                    </ol>

                    <h3>Step 9: Manage LetXPath (Optional)</h3>
                    <ol>
                        <li><strong>Extension Settings</strong>:
                            <ul>
                                <li>Click on the settings icon to choose different framework snippets</li>
                            </ul>
                        </li>
                    </ol>
                </div>
            </div>
            <div class="column col-3"></div>

        </div>
    </div>
</body>

</html>